home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / da / other.sit / Other 3.0 doc next >
Text File  |  1987-01-03  |  13KB  |  270 lines
  1. Other╔ 3.0 doc (MacWrite file)
  2. Other╔ 3.0
  3. Documentation
  4.  
  5.  
  6. Other╔ 3.0 is both an improvement over and a regression from the 1.x
  7. versions (up to version 1.6b at this writing).  They both have the
  8. same objective: to allow you to run desk accessories that haven't been
  9. installed in the System file, but instead reside in a file (created
  10. by Apple's Font/DA Mover or by Dreams of the Phoenix's DA Installer
  11. or DA Installer+), either on the disk you are using or on another disk.
  12.  Other╔ 1.x  took an approach to this problem that made it clumsy to
  13. use; limited you to running a single "additional" desk accessory at
  14. a time;  and did not allow you to use that desk accessory simultaneously
  15. with the program you were running.  The 2.x series of Other╔ (and of
  16. the FKEY DA Key, which does substantially the same thing but installs
  17. as an FKEY) represent a new approach, which I hope will be easier to
  18. use and more functional.
  19.  
  20. Other╔ 3.0  installs the vagrant DA in the Apple menu (it will stay
  21. there until you quit the program you are running, or remove it with
  22. Other╔), and you can operate it just like any other desk accessory
  23. in the menu.  There is no finagling with "save screen" options, and
  24. none of the frustration of seeing your program's window on the screen
  25. and being unable to access it.  Moreover, although Other╔ 3.0 is not
  26. crash-proof, in my own testing it has proved far more resilient than
  27. the 1.x versions.  I have not come close to testing it with every available
  28. DA.  However, in my own experience it seems to have problems only with
  29. DA's (like SkipFinder) that expect to survive beyond a single application
  30. and a few DA's that don't follow Apple's guidelines for desk accessories.
  31.  
  32.  
  33. Note:  I think the current version of Other╔ (2.1)  is pretty solid
  34. on new ROM machines, but have not tried it on machines with the old
  35. ROM or on a Mac XL.  I would particularly appreciate hearing of reproducible
  36. bugs from users with the old ROMs or Mac XLs.
  37.  
  38.                               Installing Other╔
  39.  
  40. Other╔ installs as a desk accessory in the System file. It can be installed
  41. using the Font/DA Mover from Apple, or DA Installer+ from Dreams of
  42. the Phoenix (on Quick & Dirty Utilities¬ vol. 1).  However, if you
  43. use DA Installer+, you should thereafter check the MENU resource in
  44. the System file and make certain it is set as unpurgeable.
  45.  
  46. Running Other╔ 3.0
  47.   
  48. Adding accessories to the menu
  49.  
  50. Run Other╔ just like any other desk accessory from the Apple menu.
  51.  It will appear, insert a menu and show the SFGetFile box. (If you
  52. are running HFS, DAKey should set the SFGetFile box to open to the
  53. Blessed Folder, if one there be on the default disk.)  From that box
  54. you can select any Font/DA Mover or DA Installer+ file to install --
  55. but the file should contain only a single desk accessory. Select the
  56. file and click "Open", or just double-click the file name.   You can
  57. keep the menu from appearing by holding down the Option key when you
  58. invoke Other╔.
  59.  
  60. If all goes well, the desk accessory you chose will be opened and its
  61. name installed at the bottom of the Apple menu.  The name will be preceded
  62. by the  sign to distinguish it from desk accessories installed in
  63. the normal manner╤see ConCode and Camera in the display below:
  64.  
  65.  
  66. You can then treat the newly-installed accessory just like any other,
  67. opening and closing it as you will.  It will remain installed and available
  68. until you quit the application or remove it with Other╔ 3.0 (see below
  69. for instructions how to remove the accessory). 
  70.  
  71. Automatic Renumbering
  72.  
  73. If the desk accessory you chose has an ID that is already in use, Other╔
  74. 3.0 will tell you that the slot is in use and ask whether you would
  75. like it to be renumbered.  Renumbering will take a while (usually about
  76. a minute with the old ROMs, less with the 128K ROMs), and (although
  77. I believe I have the renumbering routines working correctly now) renumbering
  78. could damage the desk accessory file on your disk, so you should not
  79. agree to renumber unless you have a backup of that file.
  80.  
  81. Closing and Removing the Installed Desk Accessory
  82.  
  83. A desk accessory installed by Other╔ 3.0 can be closed (and reopened)
  84. in the usual fashion. In addition, if you like you can both close the
  85. accessory and remove it from the Apple menu by choosing the "Remove
  86. Accessory" item from the Other╔ menu.  This will bring up a dialog
  87. box that looks more or less like the following:
  88.  
  89. From this dialog box, you can click "Cancel" to do nothing; "Remove
  90. All" to remove all desk accessories installed with DA Key; or you can
  91. click on the name of an individual desk accessory to remove it and
  92. free up the slot.  (If you have the old ROMs, the accessory's name
  93. in the Apple menu will be replaced by the disabled word, "Gone".) 
  94.  
  95.  
  96. Testing and Bug Reports
  97.  
  98. I have used Other╔ for some time on my system [512K Mac with new ROMs
  99. and a MacBottom hard disk drive].  In addition, I have attempted to
  100. test the old ROM routines by using those calls on my system.  I have
  101. fixed all the bugs that I have found but there are certainly others
  102. I haven't found.  Moreover, I haven't been able to test it at all on
  103. a Lisa running MacWorks. I'd appreciate receiving bug reports and suggestions
  104. for improvement.
  105.  
  106. Bug reports are most useful to me if you can tell me (a) your setup
  107. (version of the Mac and System you are using), (b) what program you
  108. were running, (c) what desk accessory you attempted to install, and
  109. (d) if possible, what DA's were already installed (and what if any
  110. were running) when the error occurred.
  111.  
  112. Application Notes
  113.  
  114. 1.  Each desk accessory installed by Other╔ takes up some additional
  115. memory, and requires the system to open (and maintain) one additional
  116. resource file. This means that with several accessories installed by
  117. Other╔, some operations may slow down somewhat; and it generally means
  118. that the practical limit to the number of additional accessories you
  119. can install at once is below the theoretical limit. In practice, I've
  120. found that 4 or 5 is generally safe; more than that may cause problems,
  121. depending on how the accessory, and the program that is running, handle
  122. memory. I have, however, successfully installed ten additional accessories
  123. at one time. Let me know your experiences.
  124.  
  125. 2. I have used Other╔ to run two copies of Acta simultaneously, making
  126. it easier to move back and forth between outlines. I do this by installing
  127. one copy of Acta in the System file, and keeping another copy in a
  128. desk accessory file with a special name (like "Acta Renamed"). The
  129. copy must have a different name from the version of Acta installed
  130. in the System file)╤you will probably have to use ResEd or DA Installer+
  131. to do this. (Note that just renaming the file isn't enough╤the accessory
  132. itself should be renamed.) You can then use the regular version normally,
  133. and use the copy, as a second one, through Other╔.
  134. If you do this, be careful not to open the same file in both Actas;
  135. you may get confused about which one you're using. (I have my System
  136. copy configured to automatically open the System file, and my other
  137. copy configured not to.) And if you do this from the Finder, you will
  138. note that some icons (trash can, floppy disks) turn into Acta icons
  139. because of a resource conflict. I think you can safely remove the extra
  140. ICN#'s from the renamed copy of Acta, but I'm not certain. Proceed
  141. with caution.
  142. You can probably use a similar trick to run multiple copies of other
  143. desk accessories. Let me know your experiences.
  144.  
  145. Compatability Notes
  146.  
  147. The following desk accessories, as far as I know, will not work properly
  148. if run from Other╔. They may do nothing; they may do nothing useful;
  149. or they may cause a system crash or other serious error.
  150.  
  151. Crash Fix. Installs and appears to run properly, but a System crash
  152. will generally produce a second, unrecoverable crash after the "resume"
  153. button is pressed.
  154. SkipFinder (5.3, 6.0). Installs properly, but has no effect.  Needs
  155. permanent installation in the System file to work.
  156. FadeToBlack will not work properly with DA Key.  It is hardcoded on
  157. the assumption that it resides in the System file.
  158.  
  159. The following desk accessories, as far as I know, will work if run
  160. from Other╔, but may cause occasional problems. I am not certain whether
  161. the problems relate to Other╔ or to the desk accessory running under
  162. HFS. 
  163.  
  164. Cheap Paint.  On one occasion failed to save changes, presenting an
  165. error message, "Can't save to the Scrapbook". The result was a damaged
  166. Cheap Paint desk accessory file, but no other damage. I think it is
  167. best to avoid using desk accessories that open other files (and thus
  168. may reset the default volume) while using Cheap Paint under Other╔.
  169. Sidekick (1.0).  Sometimes has trouble finding the files it needs under
  170. HFS. I think this is a general HFS problems, and not specific to DA
  171. Key. A workaround is to keep the needed files ("DeskStuff" in particular)
  172. in the root directory on a floppy disk that can be inserted as needed.
  173.  
  174. These DA's (partial list) have been run successfully with Other╔.
  175.  
  176. Talking Moose.  Still has to have MacInTalk and Moose Phrases in the
  177. System file.
  178. ConCode 1.3.
  179. Time Out.
  180. Acta (1.1).
  181. MiniWriter (1.1).
  182. Control Panel
  183. Key Caps
  184. Alarm Clock
  185. Cray Calculator
  186. Abacus
  187. ╡-Paint
  188. BackDown
  189. Q&D VT-52
  190. MockPrinter
  191. MockWrite
  192. MockTerminal
  193. Calendar Book (Sidekick)
  194.  
  195.  
  196.  
  197. Versions and Bug Fixes.
  198.  
  199. Version 2.x is the first release version of this general form of the
  200. accessory.
  201.  
  202. Version 3.0 is the first release version of the recoded (in C) accessory.
  203.  
  204. Notes for Hackers and Developers
  205.  
  206. 1.  Other╔ allows the technical user to "lock out" some driver slots
  207. to assure that Other╔ will never attempt to install a desk accessory
  208. in that slot.  The list of locked-out slots is contained in a resource
  209. of type 'mAsK' as an array of 48 bytes; $FF means the slot is locked
  210. out, $00 means the slot can be used (if Other╔ doesn't find something
  211. else installed in it).  As shipped, Other╔ locks out slots 0-11, which
  212. are reserved by Apple.  It doesn't lock out anything else.  You can
  213. change the list of locked out slots with a resource editor such as
  214. ResEdit.  
  215.  
  216. 2.  Other╔ 3.0 will attempt to open files of type 'DFIL' or 'DAMN'.
  217.  I gather that some development systems make it difficult to set the
  218. Type bits on a newly-created desk accessory. If you want, you can use
  219. FEDIT+ to search for 'DFIL' or 'DMOV' and replace the four characters
  220. of either one to whatever your development system sets as the Type
  221. bits. Alternatively, if you send me a blank disk, a mailer, and an
  222. extra $5 with your registration, I will provide you with a version
  223. of Other╔ that will attempt to open all kinds of files.
  224.  
  225. 4.  I believe strongly that Other╔ and similar accessories should not
  226. be necessary: the System, or at least the application, should support
  227. a similar feature.  To this end I am willing to make my source code
  228. available to any developer who would like to add the feature to his
  229. or her application.  Contact me if you are interested.
  230.  
  231. Registration
  232.  
  233.  
  234. Other╔ 3.0 isn't public domain software: it's shareware, and it's copyrighted.
  235. Feel free to try it out; but if you continue to use it after a week
  236. or so, you should send me $10.00 for registration. ($15 if you want
  237. a copy of the latest version on disk.)  The program has taken me a
  238. long time to write and will take me more time to support.  Please,
  239. if you use it, register it. 
  240.  
  241. If you registered any previous version of Other╔ before September 30,
  242. 1986, you should consider version 3.0 a free upgrade.
  243.  
  244. It will help me in knowing where to post upgrades if, when you register,
  245. you tell me what version you have and where you got it.
  246.  
  247. Loftus E. Becker, Jr.
  248. 41 Whitney Street
  249. Hartford, CT 06105
  250.  
  251. Compuserve 70206,67  
  252. Delphi LOFTUSBECKER 
  253. GENIE LBECKER     
  254. MCIMail LBECKER
  255.  
  256. Users' groups and others distributing disks may freely distribute Other╔
  257. under three conditions: (1) you distribute this documentation file
  258. along with the FKEY;  (2) you aren't charging users significantly more
  259. than your costs of duplication and distribution for the disks you distribute;
  260. and (3) if you charge anything for the disks, you let me know (by postcard,
  261. electronic mail, or otherwise) that you are distributing Other╔, and
  262. which version you are distributing.  
  263. Other╔ may be posted on any bulletin board without my prior permission
  264. so long as the documentation file is posted along with the FKEY.  I'd
  265. appreciate knowing where you post it, but that's a wish, not a requirement.
  266. Individuals may make as many copies of Other╔ as they want for their
  267. own use, and as many copies as they want for other people as long as
  268. the documentation file is always included with the FKEY on copies they
  269. make for others.
  270.